home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 14 / CU Amiga Magazine's Super CD-ROM 14 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-09].iso / CUCD / Sound / GSMToast / man / toast.1.txt < prev   
Encoding:
Text File  |  1996-04-28  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. TOAST(1)                  User Commands                  TOAST(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      toast - GSM 06.10 lossy sound compression
  10.  
  11. SYNOPSIS
  12.      toast [ -cdfpvhualsFC ] [ filename... ]
  13.  
  14.      untoast [ -cfpvhuaslF ] [ filename... ]
  15.  
  16.      tcat [ -vhuaslF ] [ filename... ]
  17.  
  18. DESCRIPTION
  19.      Toast compresses the sound files given on its command  line.
  20.      Each file is replaced by a file with the extension .gsm . If
  21.      no files are specified, the compression is  applied  to  the
  22.      standard  input,  and its result is written to standard out-
  23.      put.
  24.  
  25.      Toasted files can be restored to something not quite  unlike
  26.      their  original  form  by running toast -d , or untoast , on
  27.      the .gsm-files or standard input.
  28.  
  29.      The  program  tcat  (the  same  as  running  untoast  - c  )
  30.      uncompresses  its  input  on standard output, but leaves the
  31.      compressed .gsm-files alone.
  32.  
  33.      When files are compressed or uncompressed into other  files,
  34.      the ownership (if run by root), modes, accessed and modified
  35.      times are maintained between both versions.
  36.  
  37. OPTIONS
  38.      -c    (cat) Write to  the  standard  output;  no  files  are
  39.           changed.
  40.  
  41.      -d    (decode) Decode, rather than encode, the files.
  42.  
  43.      -f    (force) Force replacement  of  output  files  if  they
  44.           exist.   If -f is omitted and toast (or untoast) is run
  45.           interactively from a terminal, the user is prompted  as
  46.           to whether the file should be replaced.
  47.  
  48.      -p    (precious) Do not delete  the  source  files.   Source
  49.           files  are  implicitly left alone whenever -c is speci-
  50.           fied or tcat is run.
  51.  
  52.      -C    (LTP cut-off) Ignore most sample values when calculat-
  53.           ing  the GSM long-term correlation lag during encoding.
  54.           (The multiplications that do this are a  bottleneck  of
  55.           the  algorithm.)   The  resulting encoding process will
  56.           not produce exactly  the  same  results  as  GSM  06.10
  57.           would, but remains close enough to be compatible.
  58.           The -C option  applies  only  to  the  encoder  and  is
  59.           silently ignored by the decoder.
  60.  
  61.  
  62.  
  63. SunOS 5.4              Last change: local                       1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TOAST(1)                  User Commands                  TOAST(1)
  71.  
  72.  
  73.  
  74.      -F    (fast) On systems with a floating point processor, but
  75.           without  a  multiplication  instruction,  -F sacrifices
  76.           standard conformance to performance and nearly  doubles
  77.           the speed of the algorithm.
  78.           The resulting encoding and decoding  process  will  not
  79.           produce  exactly  the  same results as GSM 06.10 would,
  80.           but remains close enough to be compatible.
  81.           The default is standard-conforming operation.
  82.  
  83.      -v    (version)  outputs the version of toast (or untoast or
  84.           tcat) to stdout and exits.
  85.  
  86.      -h    (help)  prints a short overview of the options.
  87.  
  88.      Toast, untoast and tcat try to guess the  appropriate  audio
  89.      data  format from the file suffix.  Command line options can
  90.      also specify a format to be used for all files.
  91.      The following formats are supported:
  92.  
  93.      -u    (,U-law) 8 kHz, 8 bit ,U-law encoding (file suffix .u)
  94.  
  95.      -a    (A-law) 8 kHz, 8 bit A-law encoding (file suffix .A)
  96.  
  97.      -s    (Sun audio) 8 kHz, 8 bit ,U-law  encoding  with  audio
  98.           header (file suffix .au)
  99.  
  100.      -l   (linear) 8 kHz, 16 bit signed linear encoding  in  host
  101.           byte order with 13 significant bits (file suffix .l)
  102.  
  103.      In absence of options or suffixes to  specify  a  format,  ,
  104.      U-law encoding as forced by -u is assumed.
  105.  
  106. PECULIARITIES
  107.      A four bit magic number is prefixed to each 32 1/2-byte  GSM
  108.      frame, mainly because 32 1/2-bytes are rather clumsy to han-
  109.      dle.
  110.  
  111. WARNING
  112.      The compression algorithm used is a lossy compression  algo-
  113.      rithm devised especially for speech; on no account should it
  114.      be used for text, pictures or any other non-speech-data  you
  115.      consider valuable.
  116.  
  117. BUGS
  118.      Please direct bug reports to jutta@cs.tu-berlin.de.
  119.  
  120. SEE ALSO
  121.      gsm(3)
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. SunOS 5.4              Last change: local                       2
  130.  
  131.  
  132.  
  133.